home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / graphics / utils / videotracker / utils2 / mostra_doc < prev    next >
Text File  |  1993-05-26  |  24KB  |  578 lines
  1.  
  2.    This file describes `Mostra' 1.09, a shareware IFF utility featuring
  3. real-time unpacking scroll, dozens of options, "smart" analysis of any
  4. IFF file (FORMs, LISTs,...  also nested ILBM!), total control over
  5. display modes, simple slideshow processing, pattern matching,
  6. multipalette, double buffering, fast decompression, color cycling,
  7. TeXdocs, startup files for easy custom configurations and complete WB
  8. support.
  9.  
  10.  
  11. Introduction
  12. *************
  13.  
  14.    `Mostra' is an IFF ILBM viewer that can process *any* IFF ILBM file;
  15. this means not only IFF ILBM FORMs, but also nested ILBM, FTXT, FORMs,
  16. CATs, LISTs and PROPs. It has become reknown in the Amiga community for
  17. both its robustness and its flexibility.
  18.  
  19.    Any design requires tradeoffs: `Mostra' tries to give you a good
  20. balance of program size (less than 15K), speed (optimized assembler
  21. decompression routines) and features. It tries to be enough smart to
  22. have always reasonable defaults, but also lets you force any aspect of
  23. the display, such as resolution and video flags. While it is not
  24. possible to foresee every possible race condition, `Mostra' should be
  25. able to cope with any reasonable ILBM file.
  26.  
  27.    `Mostra' currently relies on ARP v39 in order to work. Thus, the
  28. `arp.library' file has to be in your `libs:' directory if you want to
  29. run `Mostra'. Otherwise, a message will be displayed, and `Mostra' will
  30. refuse to run. (Without ARP's powerful functions, `Mostra' would have
  31. never been released.) However, `Mostra' 2.0 will work only under
  32. Release 2 and will not need ARP.
  33.  
  34.    One of the major features in this release is support for
  35. multi-palette pictures, i.e., pictures with the new PCHG chunk which
  36. should substitute the old CTBL and SHAM chunks. See the `Changes.doc'
  37. file for additional informations. SHAM is still supported, but the
  38. support of CTBL pictures via external call has been dropped since it
  39. was shown to be unreliable.
  40.  
  41.    The other major improvement is complete support for the AGA chip set.
  42.  
  43.  
  44. Syntax
  45. *******
  46.  
  47. `Mostra' can be called both from the CLI and from the Workbench. It is
  48. also a pure program, i.e., it can be made resident.
  49.  
  50.  
  51. Command Line Usage
  52. ===================
  53.  
  54.    To get the command line syntax in AmigaDOS style, type:
  55.      M ?
  56.  
  57. This will produce the input template:
  58.      Files/...,A=All/S,R=Repeat/S,Q=Quiet/S,NoFastDraw/S,
  59.      C=Center/S,B=BlackBackground/S,W=Width/K,H=Height/K,Cycle/S,
  60.      Secs/K,Fade/K,NO=NoStartup/S,Batch/K,LockPic/S,
  61.      N=NoMouse/S,F=FreeMouse/S,LockKeys/S,NA=NoActivate/S,DB=DoubleBuffering/S,
  62.      Hires/S,Lace/S,Lores/S,NoLace/S,HAM/S,Halfbrite/S
  63.  
  64. If you ask for more help by typing `?' again, you will see:
  65.      Mostra 1.09 (C) 1990,1991,1992 Sebastiano Vigna
  66.      Usage: M <wildcards [...] | !> [All] [Repeat] [Quiet] [NoFastDraw]
  67.      [Center] [BlackBackground] [Width n] [Height n] [Cycle]
  68.      [Secs time] [Fade speed] [NoStartup] [Batch file] [LockPic]
  69.      [NoMouse] [FreeMouse] [LockKeys] [NoActivate] [DoubleBuffering]
  70.      [Hires | Lores] [Lace | NoLace] [HAM | Halfbrite]
  71.  
  72. The same help is displayed if you call `Mostra' with no arguments.
  73.  
  74.    `Mostra''s first argument is a list of patterns (or file names) as
  75. long as you want; you will get every picture whose name matches one of
  76. the patterns.
  77.  
  78.    Alternatively, you can type only the `!' character, and `Mostra'
  79. will display the ARP file requester, allowing you to search for the
  80. picture you want to show.
  81.  
  82.  
  83. Workbench Usage
  84. ================
  85.  
  86.    When `Mostra' is called from Workbench without any argument icon, it
  87. will pop the file requester and will allow you to select pictures to
  88. show until you select `Cancel' or close the file requester window.
  89. Alternatively, you can SHIFT-select multiple icons together with
  90. `Mostra''s one, or you can change the default tool of your pictures.
  91. For details about this, see Startup Tool Types. Note that if you select
  92. an IFF CAT or LIST you will have an automatic little slideshow.
  93.  
  94.  
  95. Keyboard Usage
  96. ===============
  97.  
  98.    Once you are looking at the picture you selected, you can exit by
  99. moving the mouse pointer to the very top of the screen and pressing the
  100. right button (you can also press the RETURN, SPACE or ESCAPE keys). You
  101. can drag or depth arrange the screen with the left mouse button (the
  102. gadget(s) are invisible, but they really are there!). TAB will toggle
  103. on/off color cycling. To stop pattern matching or IFF scanning use
  104. `CTRL-C' at any moment.
  105.  
  106.    If the screen size is less than the size of the picture, you can
  107. move around with cursor keys alone (moving by 8 pixels) or in
  108. combination with the SHIFT (a screenful minus 16 pixels), ALT (which
  109. brings you to the borders), or CTRL (16 pixels) keys. A noteworthy
  110. feature of `Mostra' is that the picture is *not* decrunched all at one
  111. time in a very large chunk of memory; instead, a fast LM routine
  112. decrunches the file in real-time every time you move (the routine could
  113. be faster, but it has lots of controls to get rid of damaged IFF BODY
  114. chunks; safety always first). This is not as fast as the memory-eating
  115. method, but I think it's *much* better. Very large pictures (like
  116. 800x900) will be shown in a full screen (generated on the fly at
  117. Workbench size) which you can move around. Overscan pictures will
  118. retain their size of it's not greater than 362x283 lo-res pixels
  119. (362x241 on a NTSC Amiga). For hi-res pictures, there is also a 704
  120. pixel width limit due to Intuition (724 under Release 2). Small brushes
  121. will be shown in a minimum 256x128 pixel screen. Of course, moving
  122. vertically with multi-palette pictures involves a high system overhead,
  123. since Copper lists are continuously built and deleted.
  124.  
  125.    A weird effect of this method is that you can see pictures that
  126. can't even be *loaded* into your Amiga. Let's suppose you have a really
  127. crunched picture; the BODY chunk and a 256x256 lo-res screen could take
  128. much less space than the decrunched picture, so you could create
  129. pictures that only `Mostra' could let you see in all of their parts.
  130. Why you would want to do this, well, that's another matter.
  131.  
  132.  
  133. Options
  134. ========
  135.  
  136.    This list describes all the options available in `Mostra'. The
  137. letters between parentheses denote availability of a shortening.
  138. Options can be put anywhere on the command line, or in Tool Types (see
  139. Startup Tool Types).
  140.  
  141. `All (A)'
  142.      forces a recursive scan of all of the subdirectories during the
  143.      wildcard search.
  144.  
  145. `Repeat (R)'
  146.      will endlessly restart from the first pattern when it has finished
  147.      with the last; if you used the `!' line arguments, the file
  148.      requester will pop up after every picture until you `Cancel' or
  149.      close.
  150.  
  151. `Quiet (Q)'
  152.      turns off all messages except in case of error.
  153.  
  154. `NoFastDraw'
  155.      leaves the program at priority 0; by default, `Mostra' will
  156.      surround the BODY decrunching operations with a `SetTaskPri(1)'.
  157.      This will not lock the system, but in a multitasking situation
  158.      `Mostra' will perform quickly when needed.
  159.  
  160. `Center (C)'
  161.      will force the screen to be centered (640x200 pictures on PAL
  162.      screens look so ugly...) and will use overscan if necessary. Note
  163.      that if you move the screen, and you are not under Release 2, the
  164.      centering will go away.
  165.  
  166. `BlackBackground (B)'
  167.      will create a 0-bitplane black screen that will stay until you saw
  168.      the last picture. This is for aesthetic purposes only (note that
  169.      no Chip memory will be used).
  170.  
  171. `Width (W)'
  172. `Height (H)'
  173.      want an argument that specifies a dimension of the viewing screen.
  174.      However, `Mostra' is an intelligent program, and will almost always
  175.      find the correct screen by itself. *Warning*:  dimensions allowed
  176.      are from 64 to 1024, at your own risk. Your Amiga won't crash, but
  177.      weird things can happen...
  178.  
  179. `Cycle'
  180.      will automatically activate color cycling on every picture.
  181.      Usually this happens only by request, through TAB.
  182.  
  183. `Secs'
  184.      must be followed by a number between 0 and 1000 (the zero delay
  185.      was a request from a BIXen). `Mostra' will display each picture
  186.      for the number of seconds specified, but you can skip using the
  187.      mouse or the keyboard as usual (see Keyboard Usage) or stop the
  188.      show with `CTRL-C'. Cursor keys are disabled. Greatly r